Skip to content

Conversation

@raulk
Copy link
Contributor

@raulk raulk commented Jan 13, 2026

Summary

Adapts PR #13 by @cortze to the current Jupyter/Astro architecture. Adds a new notebook visualizing network connectivity from Xatu sentry nodes:

  • Total unique peers - Hourly count of unique peers observed
  • Client distribution - Breakdown by client implementation (Geth, Lighthouse, etc.)
  • Connections per Xatu node - Peer counts for each sentry node
  • Transport protocol distribution - IPv4/IPv6 and TCP/QUIC combinations
  • Port popularity - Most commonly used P2P ports

Changes

  • queries/network_overview.py - New query fetching from libp2p_connected_local
  • notebooks/09-network-overview.ipynb - Jupyter notebook with Plotly visualizations
  • pipeline.yaml - Registered query and notebook
  • site/src/components/Icon.astro - Added Network icon

Original PR

This is an adaptation of #13 which was based on the old Quarto architecture. The visualizations and queries have been ported to the current Jupyter + papermill + nbconvert pipeline.

Test plan

  • Run just fetch <date> to fetch xatu_client_connectivity data
  • Run just render <date> to render the notebook
  • Verify notebook appears in sidebar with Network icon

raulk added 2 commits January 13, 2026 23:42
Add notebook visualizing network connectivity from Xatu sentry nodes:
- Total unique peers over time
- Client distribution (Geth, Lighthouse, etc.)
- Connections per Xatu node
- Transport protocol distribution (IPv4/IPv6, TCP/QUIC)
- Port popularity analysis

Adapted from PR #13 by Mikel Cortes to the current Jupyter/Astro
architecture (originally Quarto-based).
The project uses pandas, not polars. Rewrote data transformations
to use pandas groupby/apply operations.
@github-actions
Copy link

Preview Deployment

🚀 Preview is ready!

URL: https://observatory-staging.ethp2p.dev/pr-43/

Updated: 2026-01-14T00:16:37.418Z

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants